home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / richtext.1 < prev    next >
Text File  |  1995-07-25  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      rrrriiiicccchhhhtttteeeexxxxtttt((((1111))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 1111))))         rrrriiiicccchhhhtttteeeexxxxtttt((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           richtext - View a richtext document, typically a mail
  10.           message
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           rrrriiiicccchhhhtttteeeexxxxtttt [-c] [-f] [-n] [-p] [-t] [-o] [file]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           The _r_i_c_h_t_e_x_t program allows users to view "richtext" files
  17.           on an ASCII terminal.  It uses termcap(5) capabilities to
  18.           highlight text that is supposed to be bold or italic, and to
  19.           underline text that is supposed to be underlined.  It also
  20.           implements most of the richtext commands that have to do
  21.           with indentation and justification, as well as the "excerpt"
  22.           and "signature" commands.
  23.  
  24.           Richtext is a very simple markup language for sending rich
  25.           text through the mail.  It is not to be confused with
  26.           Microsoft's RTF (Rich Text Format).  It is part of the MIME
  27.           standard for multimedia Internet mail.
  28.  
  29.           The _r_i_c_h_t_e_x_t program takes raw richtext output on its
  30.           standard input or from a file and produces formatted output
  31.           on its standard output, which is assumed to be a terminal.
  32.           It is intended primarily for use by the metamail(1) program.
  33.  
  34.           The program will also repair the raw input to match up any
  35.           richtext command pairs that are out of order.
  36.  
  37.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  38.           When invoked with no options, _r_i_c_h_t_e_x_t expects raw richtext
  39.           on its standard input, which is corrected, and then
  40.           formatted output is written on its standard output.  The
  41.           following options can alter that behaviour:
  42.  
  43.           ----cccc      This option directs _r_i_c_h_t_e_x_t to just correct the raw
  44.                   richtext and write the corrected version to its
  45.                   standard output, without performing any formatting.
  46.  
  47.           ----ffff      This option directs _r_i_c_h_t_e_x_t to use termcap-derived
  48.                   escape codes for bold and italic text, even if
  49.                   _r_i_c_h_t_e_x_t is called in a pipe.
  50.  
  51.           ----nnnn      This option directs _r_i_c_h_t_e_x_t to not do any
  52.                   correction to the raw richtext it receives.
  53.  
  54.           ----oooo      This option directs _r_i_c_h_t_e_x_t to use overstriking for
  55.                   underlining, etc., on terminals where this is the
  56.                   most appropriate behavior.
  57.  
  58.           ----pppp      This enables the use of a pager which reports "Press
  59.                   RETURN to go on" after each screen-full of data.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      rrrriiiicccchhhhtttteeeexxxxtttt((((1111))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((RRRReeeelllleeeeaaaasssseeee 1111))))         rrrriiiicccchhhhtttteeeexxxxtttt((((1111))))
  71.  
  72.  
  73.  
  74.                   Alternatively, if the environment variable
  75.                   MMMMMMMM____UUUUSSSSEEEEPPPPAAAAGGGGEEEERRRR is present, then the pager will also be
  76.                   used.  This option and the environment variable have
  77.                   no effect if either standard input or standard
  78.                   output is redirected.
  79.  
  80.           ----aaaa      This option, which is only available under DOS,
  81.                   toggles whether or not to use ANSI mode for
  82.                   highlighting bold, italic, or underlined text.
  83.  
  84.           ----tttt      This option directs _r_i_c_h_t_e_x_t NOT to use termcap-
  85.                   derived escape codes for bold and italic text, even
  86.                   if _r_i_c_h_t_e_x_t is called in a terminal.  Instead, "*"
  87.                   and "_" will be used to highlight the affected text.
  88.  
  89.      XXXX11111111 RRRReeeessssoooouuuurrrrcccceeeessss
  90.           If you're using the xterm program, you can control what font
  91.           is used for bbbboooolllldddd text using the "xterm*boldFont" resource.
  92.  
  93.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.           metamail(1), mailto(1), termcap(5)
  95.  
  96.      BBBBUUUUGGGGSSSS
  97.           This is a very quick hack, really -- an attempt to provide
  98.           minimal richtext support for an ASCII terminal.  The author
  99.           makes no pretense of having gotten every single case right.
  100.  
  101.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  102.           Copyright (c) 1991 Bell Communications Research, Inc.
  103.           (Bellcore)
  104.  
  105.           Permission to use, copy, modify, and distribute this
  106.           material for any purpose and without fee is hereby granted,
  107.           provided that the above copyright notice and this permission
  108.           notice appear in all copies, and that the name of Bellcore
  109.           not be used in advertising or publicity pertaining to this
  110.           material without the specific, prior written permission of
  111.           an authorized representative of Bellcore.  BELLCORE MAKES NO
  112.           REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY OF THIS
  113.           MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS IS", WITHOUT
  114.           ANY EXPRESS OR IMPLIED WARRANTIES.
  115.  
  116.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  117.           Nathaniel S. Borenstein
  118.           Richtext correction algorithm by Rhys Weatherley
  119.           (rhys@cs.uq.oz.au).
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.